PATH 
Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference

     

ATSUSetVariations

Sets font variations in a style object.

OSStatus ATSUSetVariations (
                     ATSUStyle iStyle,
                     ItemCount iVariationCount,
                     ATSUFontVariationAxis iAxes[],
                     ATSUFontVariationValue iValue[]);
iStyle
A reference of type ATSUStyle. Pass a reference to a valid style object whose font variations you want to set. You cannot pass NULL for this parameter.

iVariationCount
The number of font variations you want to set. This value should correspond to the number of elements in the iAxes and iValue arrays.

iAxes
An array of values of type ATSUFontVariationAxis. Each element in the array must represent a valid variation axis. You cannot pass NULL for this parameter.

iValue
An array of values of type ATSUFontVariationValue. Each element in the array must contain a value that is valid for the corresponding variation axis in the iAxes parameter. You cannot pass NULL for this parameter.

function result
A result code. See Result Codes.
DISCUSSION
The ATSUSetVariations function sets one or more font variation (s). Unset font variations retain their font-defined default values. If the font does not support the specified variation axis, the variations will have no visual effect.

SPECIAL CONSIDERATIONS
ATSUSetVariations may allocate memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

VERSION NOTES
Available beginning with ATSUI 1.0.

© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)